home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / patches / fixsprite / fixsprite.doc < prev    next >
Text File  |  1996-04-07  |  5KB  |  145 lines
  1.  
  2.                               FixSprite V1.03
  3.  
  4.                        Adam Nelson, 27th April 1994
  5.  
  6.  
  7.  
  8.                                 DISCLAIMER
  9.                                 ----------
  10.  
  11.     You  may  copy  and  distribute  original and/or modified copies of the
  12. program's  executable  code  and  documentation  as  you receive it, in any
  13. medium.   All I ask is if you modify the code, please keep my name on it as
  14. well  as yours.  If you do a total rewrite, at least mention where the idea
  15. came from.
  16.  
  17.     The  author  will not be liable for any damage arising from the failure
  18. of  this  program  to  perform  as  described,  or any destruction of other
  19. programs or data residing on a system attempting to run the program.  While
  20. I  know  of  no damaging errors, the user of this program uses it at his or
  21. her own risk.
  22.  
  23.  
  24.                                INTRODUCTION
  25.                                ------------
  26.  
  27.     You've  just  bought that brand new AGA machine, and immediately decide
  28. to  switch  the  mouse  pointer  to  Hires  mode  via the new Prefs/Pointer
  29. program.   Very  happy  with your new pointer, you then decide to load your
  30. favourite  terminal  program  (or  anything  that  uses  sprites), and what
  31. happens?   The  mouse  pointer  changes the pointer resolution again, going
  32. into  Super-Hires  mode!   This  looks  extremely  ugly  with  the standard
  33. pointer. :-(
  34.  
  35.     This program is nothing more than a quick hack.  What it does is simply
  36. to  display  a  transparent  sprite  on  the screen, which causes the mouse
  37. pointer  to  go  into Super-Hires mode.  When you combine this with the new
  38. supplied  pointer  graphic, what you have is now a STABLE (resolution-wise)
  39. mouse pointer, and one less sprite.
  40.  
  41.  
  42.                             SYSTEM REQUIREMENTS
  43.                             -------------------
  44.  
  45.     An  Amiga  with  at  least  512Kb RAM.  FixSprite should work on any OS
  46. version,   but   won't   be  much  use  on  anything  but  an  AGA  machine
  47. (1200/4000/4000T/CD32).
  48.  
  49.  
  50.                                INSTALLATION
  51.                                ------------
  52.  
  53.     Simply    copy    the   file   Prefs/Env-Archive/Sys/Pointer.prefs   to
  54. SYS:Prefs/Env-Archive/Sys/Pointer.prefs    and   FixSprite   to   your   C:
  55. directory.
  56.  
  57.  
  58.                                    USAGE
  59.                                    -----
  60.  
  61.     The template for FixSprite is as follows:
  62.  
  63.     FixSprite n <NOREQUESTER>
  64.  
  65.     where  n  is  the  sprite  number to use from 0 to 7 (actually 0 is the
  66. mouse   pointer,  so  you  cannot  use  that).   If  the  optional  keyword
  67. NOREQUESTER is specified after the sprite number, the program will not show
  68. a  requester  saying  it  has  terminated  when  you quit the program.  The
  69. default is the requester will be shown.
  70.  
  71.     FixSprite  cannot  (yet)  be run from WorkBench.  Simply put it in your
  72. User-Startup file, e.g.
  73.  
  74.     Run >NIL: C:FixSprite 7
  75.  
  76.     To  quit  FixSprite,  simply send it a Ctrl-C signal.  This can be done
  77. with the Status and Break commands via the Shell. E.g.
  78.  
  79.     Status
  80.     Break <processnum> c
  81.  
  82.     By  default,  FixSprite will then pop up a requester saying it has been
  83. terminated.   (I hate having to type Status again after Break to see if the
  84. program really did quit).
  85.  
  86.  
  87.                                MISCELLANEOUS
  88.                                -------------
  89.  
  90.     This  is my first attempt at a half useful C program.  If someone finds
  91. any  bugs  or  ugly  programming  in  my  source  code  (included),  please
  92. re-compile  it  and redistribute it, with your modifications noted.  If you
  93. do not have access to a C Compiler, E-Mail the modified source code back to
  94. me,  and  I'll  re-compile  it.   If  someone  knows how to really fix this
  95. problem  with  the mouse pointer, (i.e.  not by displaying another sprite),
  96. rewrite the whole program!
  97.  
  98.  
  99.                      ABOUT THE AUTHOR AND THE PROGRAM
  100.                      --------------------------------
  101.  
  102.     FixSprite  has  been  created  using  SAS/C  version  6.50 and CygnusEd
  103. Professional  version 3.5 on an Amiga A1200 with 6Mb memory and a 200Mb IDE
  104. hard  drive.   The  FixSprite  documentation  was  formatted  with CygnusEd
  105. Professional version 3.5.
  106.  
  107.     If  you  have suggestions or remarks about this program, or if you find
  108. any bugs, please let me know.
  109.  
  110.     When   sending   in  bug  reports,  please  state  exactly  under  what
  111. circumstances  the bug occurred, what equipment was used and what happened.
  112. If  possible  also  try to give me enough information to reproduce the bug.
  113. It  is  very  difficult  to  find  bugs  when  you  don't know exactly what
  114. happened.   If  you  have made changes to the source code, please send me a
  115. copy of the edited source code, and a list of your changes.
  116.  
  117.     Write to either of the following addresses (E-Mail preffered) :
  118.  
  119.                    E-Mail   : i942327@redgum.ucnv.edu.au
  120.  
  121.                    Fido     : 3:635/504.10 (Adam Nelson)
  122.  
  123.  
  124.                                   HISTORY
  125.                                   -------
  126.  
  127. Version 1.03 (27/04/94)
  128. -----------------------
  129. No code changes, just re-compiled with SAS/C version 6.50.
  130.  
  131. Version 1.02 (30/01/94)
  132. -----------------------
  133. Added a command line option to disable the AutoRequester.
  134. First Public release.
  135.  
  136. Version 1.01 (29/01/94)
  137. -----------------------
  138. Changed Ctrl-F checking to Ctrl-C for compatibility.
  139. An AutoRequest will now be displayed when program is sent a Ctrl-C.
  140. Small optimisations.
  141.  
  142. Version 1.00 (25/01/94)
  143. -----------------------
  144. Initial release.
  145.